home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / windows / msk312.zip / KERMIT.HLP < prev    next >
Text File  |  1992-10-11  |  65KB  |  1,476 lines
  1.                                 MS-DOS KERMIT
  2.  
  3.         FOR THE IBM PC FAMILY, COMPATIBLES, AND OTHER MS-DOS COMPUTERS
  4.  
  5.              Version 3.12, September 1992
  6.  
  7. This file contains a summary of the commands and features of MS-DOS Kermit
  8. 3.11 and 3.12 for the IBM PC, PS/1, PS/2, and compatibles.  For detailed
  9. information, tutorials, installation and cabling hints, troubleshooting
  10. procedures, examples, diagrams, tables, and advanced features, consult "Using
  11. MS-DOS Kermit", second edition, by Christine M.  Gianone, published by Digital
  12. Press, Bedford, MA (1991), order number EY-H893E-DP, Digital Press ISBN
  13. 1-55558-082-3, Prentice Hall ISBN 0-13-952276-X, International Edition ISBN
  14. 0-13-95304306.  The book includes a 5.25-inch MS-DOS Kermit 3.11 diskette.  To
  15. order, call (USA, toll free) 1-800-343-8321.  It is also available from Kermit
  16. Distribution at Columbia University and in software stores and computer
  17. bookstores.  A German language edition, "MS-DOS Kermit -- das universelle
  18. Kommunikationsprogramm", is published by Verlag Heinz Heise GmbH & Co KG,
  19. Hannover, Germany, translated by Gisbert W. Selke, ISBN 3-88229-006-4.  A
  20. French-language edition is scheduled for publication by Schiefer & Cie,
  21. Versailles, in Fall 1992, and a Chinese edition is in preparation.
  22.  
  23.   TCP/IP users: Read the section at the end of this file and the TCP/IP
  24.   section in the "beware file" for information that was not available at
  25.   "Using MS-DOS Kermit" press time. 
  26.  
  27. TERMS AND CONDITIONS
  28.  
  29. MS-DOS Kermit is a product of Kermit Distribution, Columbia University Center
  30. for Computing Activities.  The principal author of the program is Professor
  31. Joe R. Doupnik of Utah State University, with help from other volunteer
  32. programmers all over the world.  The software is copyright 1982, 1991 by the
  33. Trustees of Columbia University in the City of New York, with portions of the
  34. source code also copyright by other institutions including Waterloo University
  35. (Ontario, Canada) and the (US) National Center for Supercomputing Applications
  36. (NCSA).
  37.  
  38. The MS-DOS Kermit software may be reproduced and shared without restriction
  39. except that it may not be licensed or sold for profit as a software product.
  40. Vendors of commercial products who wish to include MS-DOS Kermit with their
  41. products must obtain written permission of Columbia University at the address
  42. below.
  43.  
  44. Kermit software is written by volunteer programmers as a public service, and is
  45. furnished without warranty of any kind.  Neither Columbia University, nor the
  46. individual authors, nor Digital Equipment Corporation, nor Digital Press, nor
  47. any institution or individual that has contributed to the development and
  48. documentation warrant the software in any way.
  49.  
  50. CONTACT INFORMATION
  51.  
  52. Technical support: (USA) 212-854-5126, or use the e-mail addresses below.
  53.  
  54. Kermit programs are available for hundreds of different kinds of computers on a
  55. variety of magnetic media.  For MS-DOS Kermit, there are also sets of diskettes
  56. containing source code, related utilities, collections of key settings files,
  57. technical documentation, etc.  For a catalog of Kermit software and
  58. publications, write to:
  59.  
  60.   Kermit Distribution, Dept INFO
  61.   Columbia University Center for Computing Activities
  62.   612 West 115th Street
  63.   New York, NY  10025  USA
  64.  
  65. Or call (212) 854-3703, or send e-mail to:
  66.  
  67.   Info-Kermit@watsun.cc.columbia.edu (Internet) or KERMIT@CUVMA (BITNET/EARN).
  68.  
  69. UPDATES
  70.  
  71. MS-DOS Kermit 3.0 was released in February, 1990, and is fully described in
  72. "Using MS-DOS Kermit", first edition.
  73.  
  74. MS-DOS Kermit 3.11 was released September, 1991, and is fully described in
  75. "Using MS-DOS Kermit", second edition, with supplementary material on dialing
  76. and TCP/IP included in this file.
  77.  
  78. MS-DOS Kermit 3.12 was released September, 1992.  It is a maintenance release,
  79. but with several new features added, including:
  80.  
  81.  . Networking and communications improvements, including ODI support.
  82.  . Japanese Kanji text file transfer translation.
  83.  . Locking shift protocol for file transfer.
  84.  . A new method for transferring files with IBM mainframes.
  85.  
  86. The new features are described in this file.  Consult the file MSR312.UPD for
  87. more detailed information about the differences between version 3.11 and 3.12.
  88.  
  89. PROGRAM INSTALLATION
  90.  
  91. Easy.  For diskette-only systems, make a backup copy of the Kermit diskette,
  92. run Kermit from the backup copy.
  93.  
  94. For hard-disk systems, make a \KERMIT directory on your hard disk, copy the
  95. Kermit diskette files to it, and add the hard disk \KERMIT directory to your
  96. DOS PATH (modify the PATH= command in your AUTOEXEC.BAT file).
  97.  
  98. Please do not edit the standard initialization file, MSKERMIT.INI.  Make all
  99. desired communications and network setups and other customizations in your
  100. individual MSCUSTOM.INI file.  A sample is provided.  MSCUSTOM.INI is executed
  101. automatically by MSKERMIT.INI.
  102.  
  103. If you want to use a dialing directory, create a plain-text dialing directory
  104. file containing your frequently called numbers.  Instructions are given below.
  105.  
  106. If you plan to run Kermit under Microsoft Windows, copy the KERMIT.PIF file
  107. to your WINDOWS directory, and use the Windows PIF editor to make any desired
  108. changes to it.  To install an icon for Kermit, click on the group where you
  109. want to put it; click on the File menu in the Program Manager, and then
  110. choose New; select Program Item, then OK; fill in Kermit's path name and
  111. description in the dialog box.
  112.  
  113. Read the KERMIT.BWR (or MSKERM.BWR) file for problem-solving hints.
  114.  
  115. Read "Using MS-DOS Kermit" for more detailed installation instructions, as
  116. well as for complete instructions on using MS-DOS Kermit.
  117.  
  118.  
  119. DIALING AND THE DIALING DIRECTORY
  120.  
  121. MS-DOS Kermit does not have a built-in DIAL command, but if you installed
  122. Kermit from the distribution disk according to instructions, you'll be able to
  123. use the DIAL macro defined in Kermit's initialization file, MSKERMIT.INI.  DIAL
  124. uses two additional files: HAYES.SCR, a script program for dialing Hayes
  125. modems, and DIALUPS.TXT, your dialing directory.  If you do not have a Hayes or
  126. compatible modem, you can write a new script program for dialing, modelled
  127. after HAYES.SCR (see Chapter 14 of "Using MS-DOS Kermit) and set a DOS
  128. environment variable, MODEM, to be the name of your modem; the dialing script
  129. should have the same name, with a filetype of .SCR.  For example, for dialing
  130. a Rolm CBX, put the following line your AUTOEXEC.BAT file:
  131.  
  132.   SET MODEM=ROLM
  133.  
  134. and install a ROLM.SCR file in the same directory as your MSKERMIT.INI file.
  135.  
  136. If you don't have a dialing script for your type of modem, you can also dial
  137. it "manually" in CONNECT mode.
  138.  
  139. To use a dialing directory, create a plain text file called DIALUPS.TXT.  The
  140. file contains one line per entry:
  141.  
  142.   name   number   speed    parity   comments
  143.  
  144. The "name" is the name you want to use for this entry in your DIAL commands.
  145. "number" is the telephone number; "speed" is the dialing speed in bits per
  146. second, "parity" is the parity to use (even, odd, mark, space, or none).  The
  147. name, number, speed, and parity are separated from each other by one or more
  148. spaces.  Any words after the parity are ignored, so you can use them for
  149. comments.  If trailing fields (speed, parity) are omitted, Kermit's current
  150. values are used (but then you can't have a comment).  If you want to tell
  151. Kermit explicitly to use its current value for speed or parity, use an equal
  152. sign (=).  Examples:
  153.  
  154.   sprintnet  7654321      2400   mark
  155.   oofanet    6543210      1200   odd    This entry has a comment.
  156.   tymnet     93,876-5432  2400   even   You can put punctuation in the phone #.
  157.   hometone   T5551212     1200   none   T in number forces tone dialing
  158.   homepulse  P5551212     1200   none   P in number forces pulse dialing
  159.   anyspeed   999-9999     =      none   Use current speed, whatever it is.
  160.   anyparity  888-8888     9600   =      Use current parity, whatever it is.
  161.   whocares   777-7777     =      =      Use current speed and parity.
  162.   defaults   987-6543
  163.  
  164. To use the dialing directory, just type DIAL followed by the name, spelled out
  165. in full (case doesn't matter), for example:
  166.  
  167.   MS-Kermit>dial tymnet
  168.  
  169. If you type a name or number that is not in the directory, Kermit dials exactly
  170. the characters you type, for example DIAL 5552370 dials the number 5552370.
  171. DIAL FRED (if FRED is not in the directory) tells Kermit to dial the letters
  172. FRED, which won't accomplish anything useful with most modems.
  173.  
  174. To view your dialing directory, type LIST.  To view particular entries in your
  175. dialing directory, type LIST XXX, where XXX is a sequence of characters that
  176. appears in the desired entries (usually the name).  In the LIST command, case
  177. is important because it uses the DOS FIND program to list the entries:
  178.  
  179.   MS-Kermit>list tymnet
  180.   tymnet     93,876-5432  2400   even   You can put punctuation in the phone #.
  181.  
  182. In your dialing directory, you can include spaces in the name or number by
  183. enclosing it in braces, as in these examples:
  184.  
  185.   {my computer}  555-4321            2400   none
  186.   your-computer  {9 1 800 555 1234}  1200   odd
  187.   {our computer} {212 701 0000}     19200   space
  188.  
  189. Now you can type commands like DIAL MY COMPUTER, DIAL OUR COMPUTER.
  190.  
  191. The DIAL command assumes your dialing directory is stored on your PC as
  192. C:\KERMIT\DIALUPS.TXT.  If you want to keep it someplace else or you need to
  193. use some other name, create a DOS environment variable in your AUTOEXEC.BAT
  194. file:
  195.  
  196.   SET DIALFILE=C:\PHONES\DIALING.DIR
  197.  
  198. If you want to use the directory sometimes but not others, define a separate
  199. macro for dialing without it:
  200.  
  201.   define call take \m(_modem).SCR
  202.  
  203. (where _modem is defined as your modem type, e.g. HAYES, and you have an
  204. appropriate dialing script file in your PATH, e.g. HAYES.SCR).  The _modem
  205. variable is set automatically from your DOS environment variable, MODEM, and
  206. is HAYES by default (i.e. if there is no MODEM environment variable).
  207.  
  208. SUMMARY OF MS-DOS KERMIT COMMANDS
  209.  
  210. The commands listed are for the IBM PC, PS/2, and compatibles.  Other versions
  211. of MS-DOS Kermit (DEC Rainbow, NEC PC, Victor 9000, etc) lack certain commands
  212. and features described here, primarily those having to do with networking,
  213. terminal emulation, and character set translation.
  214.  
  215. Kermit commands consist of a sequence of "words" (verbs, nouns, numbers,
  216. filenames) separated by spaces and terminated by carriage return (Enter).
  217. Command description use this notation:
  218.  
  219.   <parameter>   - Replace this with an actual number, or filename, etc.
  220.   <number>      - Replace with an actual decimal number
  221.   <filename>    - A file specification, which may include disk & directory
  222.   <hh:mm:ss>    - Time of day in 24-hour notation, less than 12 hours from now
  223.   [<parameter>] - An optional field, which may be omitted
  224.   {A,B,C}       - Choose one of the items listed
  225.   [{A,B,C}]     - Optionally choose one of the items listed
  226.   = <value>     - Shows default value for a field
  227.  
  228. The following characters perform special functions in MS-DOS Kermit commands:
  229.  
  230.   Space      Separates command words ("fields").
  231.   TAB        (Ctrl-I) Like space
  232.   ESC        (Ctrl-[) Completes a keyword if possible.
  233.   Enter      (Ctrl-M, Carriage Return) Enters a command.
  234.   Formfeed   (Ctrl-L) Like Enter, but clears the screen first.
  235.   Linefeed   (Ctrl-J) Like Enter.
  236.   Backspace  (Ctrl-H, Del) Deletes rightmost character from the command.
  237.   Ctrl-W     Deletes rightmost word from the command.
  238.   Ctrl-U     Deletes the entire command.
  239.   Ctrl-C     Cancels the current command, even if you have already entered it.
  240.   ?          (Question Mark) Requests a menu for the current command field.
  241.   ;          (Semicolon) Introduces a trailing command (in command files only).
  242.   \          (Backslash) Introduces a "backslash code".
  243.   ,          (Comma) Separates commands in a macro definition.
  244.   { }        (Braces) used for grouping characters or words together.
  245.  
  246. Backslash codes are used to enter special characters into Kermit commands, and
  247. for other purposes too.  For example, if you want to use the OUTPUT command to
  248. send a Ctrl-C to the host, you can't put the Ctrl-C literally in the command,
  249. because typing Ctrl-C would cancel the command.  Instead, put a backslash
  250. followed by digits to denote the ASCII value of the Ctrl-C character (3):
  251. "output \3".  Similarly for Carriage Return: "output login myname\13".
  252.  
  253.   \123    (up to 3 decimal digits) - A decimal number or character value
  254.   \d123   (up to 3 decimal digits) - Same as 123
  255.   \o123   (up to 3 octal digits) - An octal (base 8) number or char value
  256.   \x123   (2 hexadecimal digits) - A hexadecimal (base 16) number or character
  257.   \{ }    For grouping, e.g. \{12}6 = Ctrl-L 6, not ~
  258.   \;      Include a semicolon in a TAKE-file command or macro definition.
  259.  
  260. Other backslash codes:
  261.  
  262.   \%       Introduce a Kermit variable, \%1, \%2, ..., \%a, \%b, ... \%z
  263.   \K       (or \k) Introduce a Kermit connect-mode verb like \Kexit
  264.   {\Kxxx}  A user-defined macro called xxx assigned to a key
  265.   \B       (or \b) Send a BREAK signal, 275 milliseconds (OUTPUT command only)
  266.   \L       (or \l) send a Long BREAK, 1.5 seconds (OUTPUT only, 3.12 & later)
  267.   \255     Shorthand for CRLF or LFCR   (INPUT command only)
  268.   \CD      Carrier Detect RS-232 signal (WAIT command only)
  269.   \DSR     Data Set Ready RS-232 signal (WAIT command only)
  270.   \CTS     Clear to Send RS-232 signal  (WAIT command only)
  271.   \v(name) A built-in variable like \v(date).
  272.   \m(name) A user-defined named variable
  273.   \$(name) A DOS environment variable.
  274.  
  275. * PROGRAM MANAGEMENT COMMANDS
  276.  
  277. EXIT or QUIT
  278.   Exit from MS-DOS Kermit.  Close all logs and files.  Leave serial port
  279.   and modem connections open.  Close most kinds of network connections.
  280.   Execute ON_EXIT macro if one is defined.
  281.  
  282. STAY
  283.   On the MS-DOS Kermit command line only, this causes MS-DOS Kermit to
  284.   issue its prompt after executing any other commands that were found on
  285.   the command line, rather than EXITing as it normally does when given
  286.   command-line arguments.
  287.  
  288. TAKE <filename>
  289.   Execute Kermit commands from the specified file instead of the keyboard.
  290.  
  291. PUSH
  292.   Go to DOS prompt.  Return to Kermit prompt by typing the DOS EXIT command.
  293.   Preserves connections, settings, etc.
  294.  
  295. RUN <DOS-command> [ <arguments> ]
  296.   Run a DOS program or execute a DOS command, e.g. RUN EDLIN AUTOEXEC.BAT.
  297.  
  298. ECHO [ <text> ]
  299.   For issuing messages from TAKE files or macros.  Display the <text> on the
  300.   screen, automatically supplying carriage return and linefeed at the end.
  301.   The <text> can contain backslash codes, variables, etc.  Leading and
  302.   trailing spaces are removed unless the <text> is surrounded by curly braces.
  303.   Examples:
  304.     ECHO            ; Prints a blank line
  305.     ECHO This is a message    ; Prints "This is a message"
  306.     ECHO { This is a message }    ; Prints " This is a message "
  307.  
  308. SET PROMPT <text>
  309.   Change the program prompt from MS-Kermit> to the specified text, which can
  310.   contain backslash codes, variables, etc.  Curly braces can be used as in
  311.   the ECHO command.
  312.  
  313. COMMENT <text>
  314.   For adding full-line comments to a TAKE file.
  315.  
  316. <command> ; text
  317.   Commands in TAKE files can have trailing comments preceded by semicolon (;).
  318.  
  319. <text>-
  320. <text>
  321.   Commands in TAKE files or macro definitions can be continued with hyphens,
  322.   but not in a trailing comment.
  323.  
  324. * DOS ACCESS COMMANDS
  325.  
  326. CD [<path>]
  327.   Change Directory.  Like DOS CD, but a disk drive letter can be included. 
  328.  
  329. CLS
  330.   Clear the PC's screen.
  331.  
  332. DELETE <filespec>
  333.   Delete specified file(s).
  334.  
  335. DIRECTORY [<filespec>]
  336.   Like DOS DIR command.
  337.  
  338. TYPE <filename>
  339.   Like DOS TYPE command.
  340.  
  341. SPACE [<disk-letter>]
  342.   Show free space on current or specified disk.
  343.  
  344. SHOW MEMORY
  345.   Show free memory.
  346.  
  347. Others, such as MORE, COPY, RENAME, etc, are defined as macros in MSKERMIT.INI.
  348.  
  349. * COMMANDS FOR GETTING INFORMATION
  350.  
  351. HELP
  352.   Display a brief help message about MS-DOS Kermit.
  353.  
  354. SHOW <category>
  355.   Display current settings, definitions, statistics selectively
  356.   (type SHOW ? for a list of categories that can be shown).
  357.  
  358. STATUS
  359.   Show values of most SET parameters.
  360.  
  361. VERSION
  362.   Display the program version number.
  363.  
  364. * COMMANDS FOR SETTING COMMUNICATION PARAMETERS
  365.  
  366. SET COM1 <address> [ <irq> ]
  367.   Tell Kermit the hardware address of COM1, which must be a 8250 or compatible
  368.   UART, and, optionally, that its interrupt request line number is <irq>.  Also
  369.   SET COM2, SET COM3, SET COM4.  Used to configure Kermit for nonstandard
  370.   communication boards.  If IRQ not specified, Kermit tries 3 and 4 (standard
  371.   IRQs for communication ports).  USE WITH EXTREME CAUTION: specification of
  372.   incorrect address or IRQ number could harm your PC or files.
  373.  
  374. SET PORT {COM1, COM2, COM3, COM4} = COM1
  375.   Select a communication device (SET PORT ? for list of available devices,
  376.   see below for local area nets).  You can also say SET PORT 1, SET PORT 2,
  377.   etc.  Port must be real 8250 or 16550A UART, or device that perfectly
  378.   emulates them.  If it isn't, Kermit will use BIOS rather than direct
  379.   hardware control, and will issue a message to that effect.
  380.  
  381. SET PORT {BIOS1, BIOS2, BIOS3, BIOS4}
  382.   Use BIOS-level driver for COM1, COM2, COM3, or COM4, etc, rather than
  383.   Kermit's own built-in hardware driver.  Allows Kermit to be used with BIOS
  384.   itself, BIOS Int 14H interceptors (on LANs, for example), nonstandard
  385.   devices, etc.
  386.  
  387. SET PORT <other> - See section on Local Area Networks.
  388.  
  389. SET SPEED <number>
  390.   Communications port line speed: 1200, 2400, 9600, etc.  SET SPEED ? for list.
  391.   75/1200 is "split speed" (75 out, 1200 in).  Applies to currently selected
  392.   serial port (COM1-COM4), or to EBIOS connections.  Ignored for other SET
  393.   PORT options.
  394.  
  395. SET PARITY {EVEN, ODD, MARK, SPACE, NONE} = NONE
  396.   Character parity to use during communication.  If terminal emulation works
  397.   but file transfer does not, SET PARITY to EVEN or SPACE or MARK.
  398.  
  399. SET DISPLAY { 7, 8 } = 7
  400.   Synonym for SET TERMINAL BYTESIZE { 7, 8 }
  401.  
  402. SET DUPLEX {FULL, HALF} = FULL
  403.   Select full or half duplex communication.
  404.   FULL = remote echo.  HALF = local echo plus RTS/CTS hardware handshake.
  405.  
  406. SET HANDSHAKE {NONE, XON, CR, LF, CODE <ascii-value>} = NONE
  407.   Half-duplex line turnaround character (XON is most common), mostly for
  408.   use with IBM mainframes.  Only affects file transfer.
  409.  
  410. SET FLOW-CONTROL {XON/XOFF, RTS/CTS, NONE} = XON/XOFF
  411.   Select a full-duplex flow control method.
  412.  
  413. * COMMANDS FOR CONNECTING TO A REMOTE HOST
  414.  
  415. CONNECT
  416.   Make a terminal connection to a device or another computer on the currently
  417.   selected port using the current communication settings.  Use Alt-X to return
  418.   ("escape back") to the MS-Kermit> prompt (hold down the Alt key and press x)
  419.   or Ctrl-] followed by C.  You can abbreviate CONNECT as C.
  420.  
  421. HANGUP
  422.   Hang up a dialed modem connection by lowering DTR until the next time the
  423.   communication port is accessed (by CONNECT, OUTPUT, INPUT, DIAL, PAUSE, or
  424.   similar command).  If the current connection is a network connection, close
  425.   it.
  426.  
  427. SET DEBUG SESSION
  428.   Turn off the terminal emulator, display received characters literally for
  429.   debugging: ^X = Ctrl-X, ~X = X with 8th bit on.
  430.  
  431. SET DEBUG OFF
  432.   Turn off session debugging, restore normal terminal emulation.
  433.  
  434. * COMMANDS FOR CONTROLLING TERMINAL EMULATION
  435.  
  436. SET TERMINAL [ TYPE ] { VT320, VT220, VT100, VT102, VT52, HEATH-19, 
  437.     HONEYWELL, PT200, TEK4010, NONE } = VT320
  438.   Select type of terminal to emulate.  Other types may be available, type
  439.   SET TERMINAL TYPE ? for a list.  (PT200 is a VT320-like PRIME terminal;
  440.   available in version 3.12 and later.)
  441.  
  442. SET TERMINAL ARROW-KEYS { APPLICATION, CURSOR }
  443.   Puts the arrow keys in the specified mode.
  444.  
  445. SET TERMINAL BELL { AUDIBLE, VISUAL, NONE } = AUDIBLE.
  446.   What to do with arriving BEL (beep, Ctrl-G) characters.
  447.  
  448. SET TERMINAL BYTESIZE { 7, 8 } = 7
  449.   Use 7 for stripping off parity bit, e.g. with UNIX systems, during terminal
  450.   emulation.  Use 8 for 8-bit international character sets, and for properly
  451.   receiving 8-bit control characters, such as sent by VAX/VMS applications
  452.   like EVE.
  453.  
  454. SET TERMINAL CHARACTER-SET { LATIN1, DEC-MCS, GERMAN, FRENCH, etc } = LATIN1
  455.   Character set used by the host computer during terminal emulation.  Optional
  456.   trailing parameters G0, G1, G2, and G3 can be used to designate the character
  457.   set to the given Gn tables.  Example: SET TERM CHAR LATIN1 G1.
  458.  
  459. SET TERMINAL CLEAR-SCREEN
  460.   Clear the terminal screen.
  461.  
  462. SET TERMINAL COLOR <number> [, <number> [, <number> ] ]
  463.   Set fore- and background color for text terminal emulation.  The numbers are
  464.   0 (normal foreground), 1 (high-intensity foreground), 10 (fast screen update
  465.   on IBM EGA), 3x (foreground color), 4x (background color), where x is the sum
  466.   of any of 1 (Red), 2 (Green), and 4 (Blue).
  467.  
  468. SET TERMINAL CONTROLS {7-BIT, 8-BIT}
  469.   Tell VT220/320 emulator whether to send 7-bit or 8-bit control sequences when
  470.   DEC function, arrow, editing, or keypad keys are pressed.
  471.  
  472. SET TERMINAL CURSOR-STYLE {BLOCK, UNDERLINE}
  473.   Select the cursor style for terminal emulation.  The default is underline.
  474.  
  475. SET TERMINAL DIRECTION {LEFT-TO-RIGHT, RIGHT-TO-LEFT}
  476.   Direction of screen writing during terminal emulation.
  477.  
  478. SET TERMINAL DISPLAY
  479.   Synonym for SET TERMINAL BYTESIZE.
  480.  
  481. SET TERMINAL GRAPHICS <name>
  482.   Specify the type of graphics adapter in your PC: CGA, EGA, VGA, others (SET
  483.   TERM GRAPH ? for complete list).  MS-DOS Kermit automatically tries to figure
  484.   out what kind of adapter you have.  Use this command if it guesses wrong.
  485.   Applies to Tektronix emulation only.
  486.  
  487. SET TERMINAL GRAPHICS CHARACTER-WRITING {OPAQUE, TRANSPARENT}
  488.   Tell whether text characters written on graphics screens should let graphics
  489.   show through.
  490.  
  491. SET TERMINAL GRAPHICS COLOR <number> [, <number> [, <number> ] ]
  492.   Fore- and background colors for graphics screens.  Numbers same as for
  493.   SET TERMINAL COLOR.
  494.  
  495. SET TERMINAL GRAPHICS CURSOR {ON, OFF}
  496.   Tell whether there should be a text cursor during graphics terminal
  497.   emulation.  Default is ON.
  498.  
  499. SET TERMINAL KEYCLICK {ON, OFF}
  500.   Turn keyclick on or off on keyboards that support this.
  501.  
  502. SET TERMINAL KEYPAD {APPLICATION, NUMERIC}
  503.   Put the numeric keypad into the specified mode.
  504.  
  505. SET TERMINAL MARGIN-BELL {ON, OFF}
  506.   Whether to ring the bell when the cursor nears the end of a screen line.
  507.  
  508. SET TERMINAL NEWLINE {ON, OFF}
  509.   ON means to send both a carriage return and a linefeed when you press Enter.
  510.   OFF means send only carriage return.
  511.  
  512. SET TERMINAL OUTPUT-SHIFT {NONE, AUTOMATIC, SI/SO, SS2, SS3}
  513.   (Version 3.12 and later.)  Selects the table-shifting commands surrounding a
  514.   character sent to the host when, and only when, parity is other than NONE
  515.   and the character has its high bit set.
  516.  
  517.   The idea is to form a virtual 8-bit wide communications channel by sending
  518.   7-bit material telling the host that the data byte came from the right 
  519.   hand (high bit set) side of one of the character sets G1, G2, or G3.  The 
  520.   host must obey ISO 2022 rules and have the same character set loaded into 
  521.   its right hand table.
  522.  
  523.   Option NONE, the default, says do nothing about the matter and thus the
  524.   character's high bit is lost and replaced by a parity bit.  The other
  525.   options also lose the high bit but signal the host several ways.
  526.  
  527.   Prefix SI means the following byte comes from set G1, and the character
  528.   is followed by SO which means shift back to G0; these form a triplet.
  529.   Prefix SS2 (ESCAPE N) means the following byte comes from set G2, and
  530.   similarly prefix SS3 (ESCAPE P) means from set G3. SS2 and SS3 are single
  531.   shifts which apply only for the following character.
  532.  
  533.   Option AUTO finds the character set table G1, G2 or G3 being used as the 
  534.   active right half (high bit set) of the complete set and uses SI/SO, SS2,
  535.   or SS3 appropriately. Note that VT300 level terminals use G2 as the
  536.   normal right half set, but VT100 level terminals use G1 but not G2 nor G3.
  537.  
  538. SET TERMINAL REPLAY
  539.   Synonym for REPLAY.
  540.  
  541. SET TERMINAL ROLLBACK {ON, OFF}
  542.   ON means to restore rolled-back screens to the end when new characters
  543.   arrive.  OFF means to display new characters at the current cursor position.
  544.  
  545. SET TERMINAL SCREEN-BACKGROUND {NORMAL, REVERSE}
  546.   REVERSE exchanges the fore- and background screen colors.
  547.  
  548. SET TERMINAL TABSTOPS {AT <n>, CLEAR AT <n>, CLEAR ALL}
  549.   Sets or clears screen tab stops at the specified positions.  <n> can be a
  550.   single number, a list of numbers, or <position>:<interval> to set tabs
  551.   beginning at the specified <position>, every <interval> spaces, e.g.
  552.   SET TAB AT 1:10.  By default, tabs are set every eight spaces.
  553.  
  554. SET TERMINAL TEK {ENABLE, DISABLE}
  555.   Whether Kermit should automatically enter Tektronix graphics mode upon
  556.   receipt of special escape sequences from the host.  ENABLEd by default.
  557.  
  558. SET TERMINAL UPSS {DEC-MCS, LATIN1}
  559.   Select which character set to designate as your VT220/VT320 User Preferred
  560.   Supplemental Set.
  561.  
  562. SET TERMINAL WIDTH {80, 132}
  563.   Put the video adapter into 80- or 132-column mode.  If Kermit can do this
  564.   itself, it will.  Otherwise it will attempt to run the DOS batch program
  565.   COLS80.BAT or COLS132.BAT to do the job.  You must supply these files.  They
  566.   should contain whatever external DOS commands you have at your disposal to
  567.   change the screen width.
  568.  
  569. SET TERMINAL WRAP {ON, OFF}
  570.   Whether to break overlong screen lines into multiple lines.
  571.  
  572. SET PRINTER <name>
  573.   Redirect any printing that is done during terminal emulation to a device
  574.   or file.  Default is PRN (the DOS printer device).
  575.  
  576. * LOCAL AREA NETWORKS
  577.  
  578. The SET PORT command tells Kermit which type of network connection you want to
  579. use, and in some cases also the network host you want to communicate with.
  580.  
  581. SET PORT TCP/IP [ <Internet-name or Internet-address> ]
  582.   Connect to an TCP/IP host using Kermit's built-in TCP/IP support.  If the
  583.   host is omitted, the one used in the most recent SET PORT TCP/IP or SET
  584.   TCP/IP HOST command is used, if any (this allows you to switch to another
  585.   type of connection and then back to your TCP/IP connection).  During a TCP/IP
  586.   session, Kermit uses TELNET protocol to communicate with the TELNET server on
  587.   the remote host.  See TCP/IP Network  section below.
  588.  
  589. SET PORT TCP/IP [ <Internet-name or Internet-address> [ <port> ] ]
  590.   In version 3.12 and later, a TCP port number may be included.  The default
  591.   is 23 (TELNET).  You may not specify port 25.
  592.  
  593. SET PORT TCP/IP *
  594.   Sets MS-DOS Kermit up as a TCP/IP server, awaiting a connection from a
  595.   TCP client.  After giving this command, use the SERVER to make the Kermit
  596.   server available on the network, or CONNECT to wait for an incoming "chat"
  597.   connection.  This feature works in version 3.12 and later.
  598.  
  599. SET PORT NETBIOS
  600.   Tell Kermit to use IBM Netbios rather than a serial communication port.
  601.   Kermit awaits connections from other PCs on the net.  Also used with AT&T
  602.   StarLAN/StarGROUP.
  603.  
  604. SET PORT NETBIOS <name>
  605.   Tell Kermit to connect to another PC on the Netbios network.  Also for
  606.   AT&T StarLAN/StarGroup hosts.
  607.  
  608. SET NETBIOS-NAME <name>
  609.   Tell Kermit to set your PC's Netbios node name to <name>.  Kermit
  610.   appends ".K" to the end of the name if you don't include it yourself.
  611.  
  612. SET PORT NOVELL
  613.   For using Novell network asynchronous communication servers (NASI/NACS).
  614.  
  615. SET PORT DECNET [<node> [<password>]]
  616.   For DECnet-DOS LAT or CTERM connections.  Specify node to connect to, LAT
  617.   password if required.
  618.  
  619. SET PORT UB-NET1
  620.   For Ungermann-Bass Net/One.
  621.  
  622. SET PORT OPENNET [<node>]
  623.   For Intel OpenNET, similar to Netbios.
  624.  
  625. SET PORT 3COM
  626.   For using 3COM BAPI asynchronous communication server, BRIDGE PCS or 3+OPEN
  627.   TCP versions.
  628.  
  629. SET PORT EBIOS { 1, 2, 3, 4 } [ name-of-server-port ]
  630.   Use Extended BIOS for communication with EBIOS-based asynchronous
  631.   communication servers like IBM's LANACS.
  632.  
  633. SET PORT TELAPI <Internet-address>
  634.   Connect to an Internet TCP/IP host through Novell LAN Workplace for DOS.
  635.  
  636. SET PORT TES <hostname>
  637.   Connect to a VAX/VMS system that is running Netware/VMS.
  638.  
  639. SET PORT { BIOS1, BIOS2, BIOS3, BIOS4 }
  640.   For using any network that operates through a BIOS Int 14h COM port driver.
  641.  
  642. HANGUP
  643.   Close network connection, terminate network session.
  644.  
  645. * CONNECT-MODE ESCAPE-LEVEL COMMANDS
  646.  
  647. During terminal emulation, you may type Ctrl-] (hold down Ctrl and press the
  648. rightbracket key) followed by any of the following characters (on German
  649. keyboards, hold down Strg and press +):
  650.  
  651.   ?   Help -- prints the available escape-level commands
  652.   0   (the digit zero) Transmit a NUL (ASCII 0)
  653.   B   (also Alt-B) Transmit a BREAK signal 
  654.   C   (also Alt-X) Return to Kermit prompt level, keep connection open 
  655.   F   (also Ctrl-End) File the current text screen in the screen dump file 
  656.   H   Hangup the phone or network connection
  657.   L   Transmit a Long Break (1.8 seconds)
  658.   M   Toggle the mode line, i.e. turn it off if it is on & vice versa
  659.   P   Push to DOS; get back to CONNECT by typing EXIT at the DOS prompt
  660.   Q   Temporarily quit logging the remote session
  661.   R   Resume logging the remote session
  662.   S   (also Alt-S) Show the status of the connection 
  663.   ^]  (or whatever you have set the escape character to be)
  664.       Typing the escape character twice sends one copy of it to the host
  665.  
  666. * SET TRANSLATE INPUT COMMAND
  667.  
  668.   SET TRANSLATE ON
  669.   SET TRANSLATE INPUT <code1> <code2>
  670.  
  671. Specify that when a character that would normally be translated to <code1>
  672. arrives at the communication port during terminal emulation, it should be
  673. translated into <code2> before display on the screen.  Overrides current
  674. terminal character set translation for that character.  Translations set up in
  675. this way take effect only after you give the command SET TRANSLATE INPUT ON.
  676.  
  677. * SET KEY COMMAND
  678.  
  679.   SET KEY <scancode> <value>
  680.  
  681. Assign <value> to the key whose scan code is given.  When you press the key
  682. or key combination that corresponds to the scan code during terminal
  683. emulation, the <value> is transmitted out the communication port.  If you
  684. don't know the scan code, type SET KEY alone on a line, then press the desired
  685. key or key combination when prompted, then enter the definition.  The <value>
  686. can be a single character, a text string (which may contain backslash codes),
  687. or one or more Kermit verbs.
  688.  
  689. * COMMONLY USED KERMIT KEYBOARD VERBS
  690.  
  691. The default key assignment is in parentheses.
  692.  
  693.   \Kexit        Exit from connect mode (Alt-X, Ctrl-]C)
  694.   \Kbreak       Send a BREAK signal (Alt-B, Ctrl-]B)
  695.   \Kdos         Push to DOS (Ctrl-]P)
  696.   \Kdump        Dump current screen to file (Ctrl-End)
  697.   \Khangup      Hangup communication port connection (Ctrl-]H)
  698.   \Klogoff      Stop session logging (Ctrl-]Q)
  699.   \Klogon       Resume session logging (Ctrl-]R)
  700.   \Knethold     Put network connection on hold or enter network shell (Alt-n)
  701.   \Kmodeline    Toggle mode line off/on++ (keypad minus)
  702.   \Kprtscn      Print current screen (Print Screen)
  703.   \Kreset       Reset terminal emulator (Alt-=)
  704.   \Ktermtype    Switch between text and graphics screens (Alt-minus)
  705.   \Kupscn       Roll back screen (PgUp)
  706.   \Kupone       Roll back screen one line (Ctrl-PgUp)
  707.   \Kdnscn       Roll screen forward (PgDn)
  708.   \Kdnscn       Roll screen forward one line (Ctrl-PgDn)
  709.   \KterminalR   Execute macro named TERMINALR if any
  710.   \KterminalS   Execute macro named TERMINALS if any
  711.   {\Kxxxx}      Execute macro named xxxx (xxxx can be any name)
  712.  
  713. Use SET KEY to assign or reassign these verbs to the keys of your choice.
  714. Example: "SET KEY \315 \Kexit" puts \Kexit on the F1 key.
  715.  
  716.   SET KEY CLEAR: Restore all Kermit's default key assignments.
  717.   SET KEY ON:    Use BIOS to read keystrokes (scan codes).
  718.   SET KEY OFF:   Use DOS rather than BIOS to read keystrokes.
  719.   SET KEY LK:    Use external DEC LK250 keyboard driver (if loaded).
  720.  
  721. * PRINTER CONTROL
  722.  
  723. During terminal emulation, Kermit controls the printer according to escape
  724. sequences received from the host, including the following for
  725. VT102/220/320 emulation:
  726.  
  727.   ESC [ 5 i    Begin transparent print (send port characters to printer)
  728.   ESC [ 4 i    End transparent print
  729.   ESC [ ? 5 i  Begin autoprint (send screen lines to printer)
  730.   ESC [ ? 4 i  End autoprint
  731.  
  732. Kermit also lets you use Ctrl-Print Screen to turn the printer on and off
  733. during terminal emulation.  The following command affects all these operations:
  734.  
  735. SET PRINTER <filename, PRN, or NUL>
  736.   Sends Connect mode printer material to the indicated file instead of to the
  737.   standard DOS printer name PRN; this is a "print to disk" option.  SHOW LOG
  738.   displays the current filename (defaults to PRN).
  739.  
  740. If you press Print Screen (no Ctrl), DOS gets the request itself, Kermit never
  741. sees it so the SET PRINTER command does not affect Print Screen.
  742.  
  743. * COMMANDS FOR TRANSFERRING FILES
  744.  
  745. Start a Kermit program on the remote computer, give it a "send", "receive",
  746. or "server" command, escape back to MS-DOS Kermit, and give it one of the
  747. following commands:
  748.  
  749. SEND <filename> [<alternate-name>]
  750.   Send files to remote Kermit receiver or server.  Can abbreviate as S.
  751.  
  752. RECEIVE [<filename>]
  753.   Wait for a file to arrive from the other Kermit program, which must
  754.   be given a SEND command.  Can abbreviate as R.
  755.  
  756. GET <remote-filename>
  757.   Ask a Kermit server to send the specified file(s).  Use GET <Enter>
  758.   to be prompted for remote and local names separately.
  759.  
  760. MAIL <filespec> <address>
  761.   Send the file as electronic mail to the address (if the remote Kermit
  762.   supports this feature).
  763.  
  764. * GETTING INFORMATION ABOUT FILE TRANSFER
  765.  
  766. SHOW STATISTICS
  767.   Display efficiency and other statistics about file transfers.
  768.  
  769. SHOW PROTOCOL
  770.   Display file transfer protocol-related parameter settings.
  771.  
  772. SHOW FILE
  773.   Display file-related parameter settings
  774.  
  775. * COMMANDS FOR TALKING TO A SERVER
  776.  
  777. BYE
  778.   Shut down a remote Kermit server and log out its job
  779.  
  780. FINISH
  781.   Shut down a remote Kermit server, put it back at command level
  782.  
  783. GET <remote-filename>
  784.   Ask a Kermit server to send the specified file(s)
  785.  
  786. SEND <filename> [<alternate-name>]
  787.   Send files to remote Kermit receiver or server
  788.  
  789. REMOTE CD [<directory> [<password>]]
  790.   Tell remote server to change to named directory.
  791.  
  792. REMOTE DELETE <filespec>
  793.   Tell remote server to delete the specified files.
  794.  
  795. REMOTE DIRECTORY [<filespec>]
  796.   Tell remote server to send directory listing for specified files.
  797.  
  798. REMOTE HELP
  799.   Ask the server to list the services it provides
  800.  
  801. REMOTE HOST command
  802.   Command for remote host in its own command language
  803.  
  804. REMOTE KERMIT command
  805.   Send a command to remote Kermit server in its own command language
  806.  
  807. REMOTE LOGIN user
  808.   Login to a remote Kermit server, separate prompts for password, etc.
  809.  
  810. REMOTE MESSAGE text
  811.   Send a one-line message to the remote Kermit server
  812.  
  813. REMOTE PRINT <filespec> [ <options> ]
  814.   Send the file to a remote server and ask the server to print it with the
  815.   specified options, if any.
  816.  
  817. REMOTE SET <parameter> <value>
  818.   Tell remote server to set the specified parameter to the specified value.
  819.  
  820. REMOTE SPACE [directory]
  821.   Show disk space on remote host
  822.  
  823. REMOTE TYPE filespec
  824.   Display remote file(s)
  825.  
  826. REMOTE WHO
  827.   Display users logged on remote system
  828.  
  829. * COMMANDS FOR ACTING AS A SERVER
  830.  
  831. DISABLE <parameter>
  832.   Disable various capabilities of the server (DISABLE ? for list)
  833.  
  834. ENABLE <parameter>
  835.   Enable various capabilities of the server (ENABLE ? for list)
  836.  
  837. SET SERVER TIMEOUT <num>
  838.   How often the server should send NAK packets while waiting for a command,
  839.   0 = never (default).
  840.  
  841. SET SERVER LOGIN <name> <password>
  842.   Set up a name and password which must be sent to the server (by REMOTE
  843.   LOGIN) before it will accept any other commands.
  844.  
  845. SHOW SERVER
  846.   Examine server-related parameters.
  847.  
  848. SERVER [{<seconds>, <hh:mm:ss>}]
  849.   Act as a Kermit server, optionally for or until the given time.  Default time
  850.   is forever (until BYE or FINISH received, or interrupted with Ctrl-C).
  851.  
  852. The MS-DOS Kermit server honors the following requests:
  853.  
  854.   SEND        REMOTE CWD        REMOTE PRINT
  855.   GET         REMOTE DELETE     REMOTE MESSAGE
  856.   FINISH      REMOTE DIRECTORY  REMOTE SPACE
  857.   BYE         REMOTE HOST       REMOTE TYPE
  858.   LOGOUT      REMOTE KERMIT     REMOTE SET
  859.  
  860. * INTERRUPTION COMMANDS WHILE A FILE TRANSFER IS IN PROGRESS
  861.  
  862.   X or Ctrl-X: Stop sending the current file and go on to the next one, if any.
  863.   Z or Ctrl-Z: Stop sending this file, and don't send any further files.
  864.   E or Ctrl-E: Send Error packet to the remote Kermit.
  865.   C or Ctrl-C: Return to Kermit command level immediately.
  866.   Q or Ctrl-Q: Send a Ctrl-Q (Xon).
  867.   Enter key:   Try to wake up a stuck file transfer.
  868.  
  869. * CHANGING FILE TRANSFER PARAMETERS
  870.  
  871. SET ATTRIBUTES { ON, OFF } = ON
  872.   Enable/Disable processing of file attribute packets.
  873.  
  874. SET ATTRIBUTES { DATE, LENGTH, TYPE, CHARACTER-SET } { ON, OFF } = ON
  875.   Enable/Disable processing of specific file attributes.
  876.  
  877. SET BLOCK-CHECK { 1, 2, 3 } = 1
  878.   Level of error checking, 1 by default, 3 is strongest.
  879.  
  880. SET BLOCK-CHECK BLANK-FREE-TWO
  881.   (Version 3.12 and later.)  Like SET BLOCK-CHECK 2, but formats the block
  882.   check characters such that they never include blanks.
  883.  
  884. SET DEBUG PACKETS
  885.   Display packets on screen during file transfer.
  886.  
  887. SET DEBUG OFF
  888.   Turn off display of packets.
  889.  
  890. SET DESTINATION { DISK, PRINTER, SCREEN } = DISK
  891.   Direct incoming files to the specified device.
  892.  
  893. SET FILE DISPLAY { SERIAL, REGULAR, QUIET } = REGULAR
  894.   Format of Kermit's file transfer display.  Use SERIAL for hardcopy terminals,
  895.   Braille devices, speaking devices, etc.  QUIET means no display at all (used
  896.   automatically in remote mode).  Synonym: SET DISPLAY.
  897.  
  898. SET EOF { CTRL-Z, NOCTRL-Z } = NOCTRL-Z
  899.   Whether Ctrl-Z marks the end of a PC DOS text file.
  900.  
  901. SET FILE TYPE { TEXT, BINARY } = TEXT
  902.   TEXT implies record format conversion and character set translation.  Use
  903.   BINARY to send or receive files with no conversaion at all.
  904.  
  905. SET FILE COLLISION { DISCARD, OVERWRITE, RENAME }
  906.   What to do when a file arrives that has the same name as an existing file:
  907.     RENAME   = Automatically give the arriving file a unique name (default).
  908.     OVERWITE = Overwrite the existing file with the new file.
  909.     DISCARD  = Reject any file that has the same name as an existing file.
  910.  
  911. SET FILE CHARACTER-SET { CP437, CP850, CP860, CP863, CP865, CP866, SHIFT-JIS }
  912.   Tell Kermit which IBM PC code page to use when sending or receiving a
  913.   text file.  Default is your current PC code page.  Kermit translates between
  914.   the current file character set and the transfer character set.  SHIFT-JIS
  915.   is Code Page 932 for Japanese Kanji, available on in version 3.12 and later.
  916.  
  917. SET TRANSFER CHARACTER-SET { TRANSPARENT, LATIN1, CYRILLIC, JAPANESE-EUC }
  918.   Tell Kermit the character set used in Kermit packets.  TRANSPARENT, the
  919.   default, means no translation.  LATIN1 is ISO Latin Alphabet 1, useful for
  920.   transferring text that contains accented characters with other Kermit
  921.   programs that support this feature.  CYRILLIC is ISO 8859-5 Latin/ Cyrillic,
  922.   and can be used only with file character-set CP866.  JAPANESE-EUC is used
  923.   for Japanese Kanji and can be used only with FILE CHARACTER-SET SHIFT-JIS,
  924.   available only in version 3.12 and later.
  925.  
  926. SET TRANSFER LOCKING-SHIFT { OFF, ON, FORCED }
  927.   If PARITY is other than NONE, MS-DOS Kermit 3.12 and later automatically
  928.   uses a new locking-shift technique for transferring 8-bit more efficiently
  929.   over the 7-bit connection.  To turn off this feature, use OFF.  To force the
  930.   use of this feature even when parity is NONE, use ON.  Locking shift
  931.   protocol is negotiated automatically with the other Kermit and is presently
  932.   supported by C-Kermit 5A, IBM Mainframe Kermit 4.2.3, and MS-DOS Kermit 3.12.
  933.  
  934. SET TRANSLATION CHARACTER-SET {READABLE, INVERTIBLE}
  935.   (Version 3.12 and later.)  The default is READABLE, which optimizes
  936.   character-set conversion for "readability", rather than invertibility.
  937.   INVERTIBLE gives a unique translation for each character between the FILE
  938.   CHARACTER-SET and the TRANSFER CHARACTER-SET.
  939.  
  940. SET UNKNOWN-CHARACTER-SET { DISCARD, KEEP } = KEEP
  941.   What to do when a file arrives that has an unknown character set.
  942.  
  943. SET FILE WARNING { ON, OFF, NO-SUPERSEDE } = ON
  944.   Obsolete synomym for SET FILE COLLISION.
  945.  
  946. SET INCOMPLETE { KEEP, DISCARD } = DISCARD
  947.   What to do with a file that does not arrive completely.
  948.  
  949. SET RETRY <number> = 5
  950.   How many times to retry a particular packet before giving up on the file.
  951.  
  952. SET TIMER { ON, OFF } = ON
  953.   Enable/Disable timeouts and retransmissions during file transfer.
  954.  
  955. SET WINDOW <num> = 1
  956.   Number of sliding window packet slots.  Sizes greater than 1 can be used
  957.   only with other Kermit programs that supports sliding windows.  Improves
  958.   transmission efficiency on long-delay or noisy connections.
  959.  
  960. SET SEND (or RECEIVE) <parameter> <value>
  961.   START-OF-PACKET <num> = 1  packet begin character, normally Ctrl-A
  962.   END-OF-PACKET <num> = 13   packet end character, normally carriage return
  963.   PACKET-LENGTH <num> = 94   packet length; 2000 max; > 94 for "long packets"
  964.   PAUSE <num> = 0            Interpacket pause, milliseconds
  965.   TIMEOUT <num> = 5          Timeout interval waiting for a packet, seconds
  966.   PADDING <num> = 0          How many padding characters before each packet
  967.   PADCHAR <num> = 0          Padding character to use
  968.   DOUBLE-CHAR <num>          Double packet character <char> when sending.
  969.   IGNORE-CHAR <num>          Discard <char> from packets when receiving.
  970.  
  971. Use SHOW FILE, SHOW PROTOCOL to examine current file transfer settings.
  972.  
  973. * COMMANDS FOR FILE TRANSFER WITHOUT ERROR CHECKING
  974.  
  975. Kermit can also transfer files or other information with remote computers,
  976. services, or devices that do not support the Kermit file transfer protocol.
  977. These methods provide no error detection or correction.  Use with caution.
  978.  
  979. TRANSMIT <filename>
  980.   Send a text file to the host as if you were typing it at the keyboard
  981.   a line at a time.  Waits for linefeed (\10) to echo before sending next
  982.   line.  Uses all current communication settings (parity, flow, etc).
  983.   Does'nt translate character sets.  CRLF is sent as CR only unless SET
  984.   TRANSMIT LINE-FEEDS ON.  Empty lines are sent as pairs of CRs (or CRLFS)
  985.   unless SET TRANSMIT FILL is used.
  986.  
  987. SET TRANSMIT <parameter> <value>
  988.   Various parameters used to control TRANSMIT command.
  989.   FILL-EMPTY-LINE { NONE, SPACE, <char> }
  990.   LINE-FEEDS-SENT { ON, OFF }
  991.   PAUSE <number> - pause <number> milliseconds after sending each line.
  992.   PROMPT <char> - character to wait for before sending next line (= \10)
  993.  
  994. LOG SESSION <filename>
  995.   Capture a remote file, which you must TYPE, into the named file
  996.   (SESSION.LOG by default).  Use \Klogoff and \Klogon keyboard verbs to
  997.   stop and restart logging (Ctrl-]Q, Ctrl-]R).
  998.  
  999. CLOSE SESSION
  1000.   Stop capturing and close the session log file.
  1001.  
  1002. * COMMANDS FOR RECORDING THINGS
  1003.  
  1004. LOG TRANSACTION [<filename>] = TRANSACT.LOG
  1005.   Log file transfer names, times, etc, in given file.
  1006.  
  1007. LOG SESSION [<filename>] = SESSION.LOG
  1008.   Record terminal session in given file.
  1009.   Use REPLAY <filespec> to view the log.
  1010.  
  1011. LOG PACKETS [<filename>] = PACKET.LOG
  1012.   Record file transfer packets in given file.
  1013.  
  1014. WRITE {FILE, PACKET, SESSION, TRANSACTION, SCREEN} [<text>]
  1015.   Write the text to the specified log file or to the screen.  Text may contain
  1016.   backslash codes, variables, etc.  Kermit does not supply line terminators
  1017.   so include \13\10 at the end of the text if you want the text to end in CRLF.
  1018.  
  1019. CLOSE {PACKET, SESSION, TRANSACTION, READ, WRITE, ALL}
  1020.   Close the specified log file and stop logging.
  1021.  
  1022. SHOW LOG
  1023.   Display names and status of logging and log files.
  1024.  
  1025. Ctrl-]F (while in Connect mode)
  1026.   Dump current text screen into a file (even if graphics screen is showing).
  1027.  
  1028. Ctrl-End (while in Connect mode)
  1029.   Dump the current screen (text or graphics) into a file.
  1030.  
  1031. SET DUMP <name>
  1032.   Specify name of screen dump file for text screens (KERMIT.SCN by default).
  1033.   Graphics screens are saved to TEKPLTnn.TIF.
  1034.  
  1035. * MACROS
  1036.  
  1037. DEFINE <macro-or-variable-name> [<text>]
  1038.   Defines a macro or variable called "<name>" to have the given value.  If
  1039.   <text> is omitted, undefines the named macro or variable.  When defining
  1040.   command macros, <text> should be a list of MS-DOS Kermit commands, separated
  1041.   by commas.  This command can also be used to define a variable like \%1, \%a,
  1042.   etc.  The definition is copied literally (backslash codes not interpreted).
  1043.  
  1044. [DO] <macro-name> [<parameter1> [<parameter2> [<parameter3> [...]]]]
  1045.   Executes the macro called "<name>", and assigns the parameters, if any, to
  1046.   the variables \%1, \%2, \%3, etc, and sets the variable ARGC to the number of
  1047.   parameters plus one (1 = no parameters, 2 = 1 parameter, etc).  The variable
  1048.   \%0 is assigned the name of the macro.  These variables are available only
  1049.   within the macro.
  1050.  
  1051. ASSIGN <macro-or-variable-name> [<text>]
  1052.   Like DEFINE, copies the current value of <text> into the macro or variable,
  1053.   but (unlike DEFINE) all variables in the <text> are evaluated first.
  1054.  
  1055. SHOW MACRO [<name>]
  1056.   Shows the definition of the specified macro or variable.
  1057.  
  1058. IF DEFINED <name> <command>
  1059.   Executes the <command> if the macro or variable name is defined.
  1060.  
  1061. IF = ARGC <num> <command>
  1062.   Executes <command> if ARGC is equal to <num> (numeric constant or variable)
  1063.  
  1064. IF < ARGC <num> <command>
  1065.   Executes <command> if ARGC is less than <num>
  1066.  
  1067. IF > ARGC <num> <command>
  1068.   Executes <command> if ARGC greater than <num>
  1069.  
  1070. IF NOT > ARGC <num> <command>
  1071.   Executes <command> if ARGC less than or equal to <num>
  1072.  
  1073. IF =, <, >
  1074.   Can also be used with any numeric variables or constants, not just ARGC,
  1075.   including the other predefined numeric variables, VERSION, COUNT, and
  1076.   ERRORLEVEL, the built-in numeric variables like \v(ndate), \v(status), etc,
  1077.   or any other variable (\%1, \%a) that has a numeric value.  Use IF EQUAL to
  1078.   compare character strings (see below).
  1079.  
  1080. * VARIABLES
  1081.  
  1082. \%0 is the name of the currently executing macro (if any).  \%1 thru \%9 are
  1083. its parameters (arguments), created when the macro is invoked and destroyed
  1084. when it terminates.  If a macro invokes another macro, a new set of arguments
  1085. is created and the old set is preserved.  (This is a change from 3.01 and
  1086. earlier, in which macro arguments were global.)
  1087.  
  1088. \%a through \%z are global variables that can be modified or accessed in any
  1089. context.  Created by DEFINE, ASSIGN, ASK, ASKQ, or READ.
  1090.  
  1091. The following commands can be used in version 3.12 and later for arithmetic on
  1092. variables that have numeric values:
  1093.  
  1094. INCREMENT <variable-name> [ <number> ]
  1095.   Adds <number>, if given, to the value of the named variable.  If no <number>
  1096.   is given, adds 1.
  1097.  
  1098. DECREMENT <variable-name> [ <number> ]
  1099.   Subtracts <number>, if given, to the value of the named variable.  If no
  1100.   <number> is given, subtracts 1.
  1101.  
  1102. Macro definitions can be used as variables too.  DEFINE or ASSIGN the macro in
  1103. the normal way, but refer to it using \m(name), for example:
  1104.  
  1105.    define phone-number 7654321
  1106.    if not defined phone-number echo Phone number is is not defined!
  1107.    echo The phone number is \m(phone-number).
  1108.    dial \m(phone-number)
  1109.  
  1110. \v(xxx) is a built-in variable, where xxx is its name:
  1111.    \v(argc)        macro argument count
  1112.    \v(count)       current value of loop counter (SET COUNT / IF COUNT)
  1113.    \v(date)        current date in country format, e.g. dd-mm-yyyy 08-02-1991
  1114.    \v(ndate)       numeric date yyyymmdd, e.g. 19910208
  1115.    \v(directory)   current disk and directory, e.g. C:\LETTERS\
  1116.    \v(errorlevel)  current value of ERRORLEVEL variable (SET ERRORLEVEL)
  1117.    \v(keyboard)    IBM PC keyboard type: 88, 101, or (for LK250) 250.
  1118.    \v(line)        Same as \v(port)
  1119.    \v(platform)    PC type, e.g. IBM-PC, DEC-RAINBOW
  1120.    \v(port)        Current SET PORT value
  1121.    \v(program)     Program name, MS-DOS_KERMIT
  1122.    \v(speed)       Current transmission speed (only for COM1..4, EBIOS)
  1123.    \v(status)      0 if previous command succeeded, nonzero if it failed.
  1124.    \v(system)      MS-DOS
  1125.    \v(terminal)    Current terminal emulation type, e.g. VT320 (3.12 & later)
  1126.    \v(time)        Current time of day, hh:mm:ss, e.g. 12:30:01
  1127.    \v(version)     Numeric program version, e.g. 311 for version 3.11.
  1128.  
  1129. \$(xxx) is a DOS environment variable, e.g. \$(COMSPEC).
  1130.  
  1131. * SCRIPT COMMANDS
  1132.  
  1133. These commands are used (in conjunction with other Kermit commands) for
  1134. carrying out an automated dialog with a remote computer.
  1135.  
  1136. ASK <variable> <prompt>
  1137.   Print the <prompt> on the screen, assign what user types to the <variable>.
  1138.  
  1139. ASKQ <variable> <prompt>
  1140.   Like ASK, but do not echo what user types.
  1141.  
  1142. INPUT [<timeout>] <string>
  1143.   Wait up to <timeout> secs for <string> to arrive at communications port.
  1144.   If it arrives, set SUCCESS.  If not, time out and set FAILURE.
  1145.   String may contain backslash codes.
  1146.  
  1147. OUTPUT <string>
  1148.   Send the <string> out the communications port.  May include backslash
  1149.   codes, variables, etc, plus the special items \B to send a BREAK and
  1150.   \L to send a Long BREAK.
  1151.  
  1152. SET INPUT CASE { IGNORE, OBSERVE } = IGNORE
  1153.   Say whether alphabet case should matter in searching for INPUT string.
  1154.  
  1155. SET INPUT DEFAULT-TIMEOUT <secs> = 1
  1156.   Timeout interval to use if none given in INPUT command.
  1157.  
  1158. SET INPUT ECHO { ON, OFF } = ON
  1159.   Whether to display characters read by INPUT command on the screen.
  1160.  
  1161. SET INPUT TIMEOUT-ACTION { PROCEED, QUIT } = PROCEED
  1162.   PROCEED means set SUCCESS or FAILURE and go on to next statement in macro
  1163.   definition or TAKE file.  QUIT means to quit from current macro or TAKE
  1164.   file immediately upon timeout (i.e. upon failure).
  1165.  
  1166. IF SUCCESS <command>
  1167.   Execute the <command> if the preceding INPUT command succeeded.  Also works
  1168.   with file transfer commands like SEND, RECEIVE, GET, BYE, etc.
  1169.  
  1170. IF FAILURE <command>
  1171.   Execute the <command> if the preceding INPUT or file transfer command failed.
  1172.  
  1173. PAUSE <secs>
  1174.   Do nothing for specified number of seconds, or until any character is typed
  1175.   at the keyboard.
  1176.  
  1177. WAIT [<timeout>] [DTR] [CD] [CTS]
  1178.   Wait <timeout> (seconds or until time hh:mm:ss) for specified modem signals.
  1179.  
  1180. CLEAR
  1181.   Clear communications port input buffer.
  1182.  
  1183. STOP
  1184.   Return immdediately from the current macro or TAKE file to the MS-Kermit>
  1185.   prompt.
  1186.  
  1187. STOP [ <number> ] [ <text> ]
  1188.   (Version 3.12 and later.)  Return immdediately from the current macro or
  1189.   TAKE file to the MS-Kermit> prompt, using the <number>, if specified, as the
  1190.   SUCCESS / FAILURE code, and setting the value of \v(status) to that number.
  1191.   If the <number> is omitted, the SUCCESS / FAILURE status of the previous
  1192.   command is retained and \v(status) is not changed.  If the optional <text>
  1193.   is given, it is printed on the screen.  Leading and trailing spaces are
  1194.   removed unless the text is enclosed in curly braces, in which case only the
  1195.   curly braces are removed.  Examples:
  1196.  
  1197.     STOP            ; No message, status is not changed
  1198.     STOP 0            ; No message, statis is 0 (SUCCESS)
  1199.     STOP 1            ; No message, status is 1 (FAILURE)
  1200.     STOP This is a message    ; Status not changed, message is printed
  1201.     STOP {  Indented text}    ; Ditto, leading spaces are preserved
  1202.     STOP 0 This is a message    ; Status set to 0, message is printed
  1203.     STOP 1 { This is a message}    ; Status set to 1, message is printed
  1204.  
  1205. END
  1206.   Return from current macro or TAKE file to the macro or TAKE file which
  1207.   invoked it, or if none, to the MS-Kermit> prompt.  Synonym: POP.
  1208.  
  1209. END [ number ] [ text ]
  1210.   (Version 3.12 and later.)  Return from current macro or TAKE file to the
  1211.   macro or TAKE file which invoked it, or if none, to the MS-Kermit> prompt.
  1212.   Otherwise, identical to STOP.  Synonym: POP.
  1213.  
  1214. GOTO <label>
  1215.   Instead of executing the next statement in the current macro definition or
  1216.   TAKE-file, go to the specified label and begin executing there.  The label
  1217.   must be a word that begins with a colon (:) in the left margin in a macro
  1218.   definition or TAKE file.  If it is not found, Kermit "POPs" one level and
  1219.   looks there, and so on through all active macros and command files.
  1220.  
  1221. :LOOP
  1222.   The previous line shows a label called "loop".  GOTO LOOP would find it.
  1223.  
  1224. REINPUT <timeout> <string>
  1225.   Like INPUT, but instead of waiting for <string> to arrive at communications
  1226.   port, REINPUT rescans the text that has already arrived.
  1227.  
  1228. SET COUNT <number>
  1229.   Sets the loop counter to <number>.
  1230.  
  1231. IF COUNT <command>
  1232.   Subtract one from count.  If result is greater than 0, execute <command>.
  1233.   Use with GOTO to construct counted loops.
  1234.  
  1235. SET ALARM <time>
  1236.   Set an alarm <time> seconds from now, or at time hh:mm:ss.
  1237.  
  1238. IF ALARM <command>
  1239.   If the alarm time has passed, execute the <command>.
  1240.  
  1241. SET ERRORLEVEL <number>
  1242.   Set errorlevel to be returned to DOS by Kermit upon exit.
  1243.  
  1244. IF ERRORLEVEL <number> <command>
  1245.   If ERRORLEVEL of most recently executed DOS command matches or exceeds
  1246.   <number>, execute the <command>.
  1247.  
  1248. IF EXIST <filename> <command>
  1249.   If the named file exists, execute the <command>.
  1250.  
  1251. IF INPATH <filename> <command>
  1252.   If the named file can be found in your DOS PATH, or in the current
  1253.   directory, execute the <commmand> (version 3.12 and later).
  1254.  
  1255. IF EQUAL <word1> <word2> <command>
  1256.   Execute the command if the two words are the same.  The words may be text or
  1257.   variables.
  1258.  
  1259. IF LGT <word1> <word2> <command>
  1260. IF LLT <word1> <word2> <command>
  1261.   Execute the command if <word1> is lexically greater than (LGT) or lexically
  1262.   less than (LLT) <word2>.  EQUAL, LGT, and LLT are alphabetical comparisons.
  1263.   Case is treated according to SET INPUT CASE.  To compare text items that
  1264.   contain spaces, use { brackets } for grouping:
  1265.     IF LLT {\%a} {more than one word} <command>
  1266.  
  1267. OPEN {READ, WRITE, APPEND} <filename>
  1268.   Open a DOS file in the given mode.
  1269.  
  1270. READ <variable-name>
  1271.   Read a line from the current OPEN READ file into the given variable,
  1272.   discarding line terminators.  Sets FAILURE flag at end of file.
  1273.  
  1274. WRITE FILE <text>
  1275.   Write the text into the current OPEN WRITE or OPEN APPEND file; <text> can
  1276.   contain any mixture of ordinary characters, backslash codes, variable names.
  1277.  
  1278. CLOSE {READ, WRITE}
  1279.   Close the current READ or WRITE (including APPEND) file.
  1280.  
  1281. * TCP/IP NETWORK SETUP
  1282.  
  1283. This section assumes knowledge of TCP/IP.  See "Using MS-DOS Kermit" for
  1284. additional explanatory material, or Douglas Comer's book "Internetworking with
  1285. TCP/IP" (Prentice-Hall), or show this material to your network manager.
  1286.  
  1287. To use Kermit's built-in TCP/IP support, you need a network adapter, an
  1288. Ethernet-style packet driver (not device driver) for the adapter, or a
  1289. Novell ODI driver for Ethernet, Token Ring, Arcnet, or PCnet, and a
  1290. connection to a TCP/IP network.  NDIS drivers can be used by using protocol
  1291. shim program DIS_PKT on the top of NDIS to form a Packet Driver; the latest
  1292. version is named DIS_PKT9 from Joe Doupnik at Utah State University.
  1293.  
  1294. Install either an Ethernet-style packet driver or an ODI driver for for
  1295. your PC's network interface, or a SLIP packet driver for your PC's serial
  1296. port.  For Token Rings, install the IBMTOKEN.COM driver on top of the Token
  1297. Ring board drivers or use ODI.  For NDIS (LAN Manager) environments, install 
  1298. the DIS_PKT "shim" on top of the NDIS drivers.  IBMTOKEN and DIS_PKT are 
  1299. available from Columbia as part of the packet driver collection (see below).
  1300.  
  1301. If you plan to make Kermit TCP/IP connections under Microsoft Windows, you
  1302. must either:
  1303.  
  1304.  (a) Configure Windows to "Lock Application Memory" in your KERMIT.PIF file.
  1305. or:
  1306.  (b) Install WINPKT.COM after installing your packet driver, with WINPKT
  1307.      set to a lower interrupt number than the packet driver (see WINPKT.HLP
  1308.      for instructions and examples).
  1309.  
  1310. If your network interface vendor did not supply you with a packet driver, they
  1311. are available via anonymous FTP from Columbia University, host
  1312. watsun.cc.columbia.edu [128.59.39.2], cd packet-drivers, get the READ.ME file,
  1313. read it, and take it from there.  These files, now called the Crynwyr packet
  1314. driver collection, are also available from Columbia University via mail order.
  1315. WINPKT is also available from Columbia.
  1316.  
  1317. Before Kermit can use the TCP/IP network, you must use SET TCP/IP commands to
  1318. supply Kermit with the necessary details about it.  Check with your network
  1319. manager to find out the correct values for these commands, and then put them
  1320. in your MSKERMIT.INI file.  Don't make them up!
  1321.  
  1322. You can view your TCP/IP settings with the SHOW COMMUNICATIONS command.
  1323.  
  1324. SET TCP/IP ADDRESS <IP-address or BOOTP or RARP>
  1325.   Tell Kermit your PC's IP address (required).  If your local network has a
  1326.   BOOTP or RARP server, you can SET TCP/IP ADDRESS BOOTP or RARP to have the
  1327.   server download your IP address automatically.  Examples:
  1328.     SET TCP/IP ADDRESS 128.59.77.23 ; My IP address, fully specified
  1329.     SET TCP/IP ADDRESS BOOTP        ; Get my address from a BOOTP server
  1330.     SET TCP/IP ADDRESS RARP         ; Get my address from a RARP server
  1331.  
  1332. SET TCP/IP SUBNETMASK <IP-address-mask>
  1333.   Tell Kermit which portion of an IP address corresponds to your physical
  1334.   network.  The default is 255.255.255.0.  A correct value is essential; it is
  1335.   used by Kermit to tell whether an IP address is on your physical network
  1336.   or must be accessed through a gateway.  Incorrect values prevent successful
  1337.   communication.  The subnetmask can be downloaded by BOOTP.
  1338.  
  1339. SET TCP/IP BROADCAST <IP-broadcast-address>
  1340.   Tell Kermit the IP address to use when sending IP broadcast messages, for
  1341.   example to the BOOTP server, and to recognize incoming ones.  The default is
  1342.   255.255.255.255, meaning "my own physical network".  Change this parameter
  1343.   if your BOOTP server is on a different subnet of your local network, or if
  1344.   your local network uses the old 4.2 Berkeley UNIX convention of 0's rather
  1345.   than 1's for IP broadcast addresses.  An incorrect value can prevent
  1346.   successful communication, or worse.
  1347.  
  1348. SET TCP/IP PRIMARY-NAMESERVER <IP-address>
  1349.   The IP address of your network's primary nameserver, which translates
  1350.   hostnames into IP addresses.  Required if you want to use host names rather
  1351.   than numeric IP addresses in your SET PORT TCP/IP commands.  Example:
  1352.     SET TCP/IP PRIMARY-NAMESERVER 128.59.77.1
  1353.   Can also be downloaded automatically by BOOTP.
  1354.  
  1355. SET TCP/IP SECONDARY-NAMESERVER <IP-address>
  1356.   The IP address of your network's secondary nameserver, used by Kermit if the
  1357.   primary nameserver is unavailable.  If no nameserver is reachable, use IP
  1358.   host numbers rather than names in your SET PORT TCP/IP commands.  Nameserver
  1359.   addresses can also be downloaded automatically by BOOTP.
  1360.  
  1361. SET TCP/IP GATEWAY <IP-address>
  1362.   The IP address of the gateway between your local area network and the rest of
  1363.   the Internet.  Required if you want to communicate outside of your immediate
  1364.   local network.  Can also be downloaded automatically by BOOTP.
  1365.  
  1366. SET TCP/IP HOST <IP-address or hostname>
  1367.   The default host for SET PORT TCP/IP commands.  SET PORT TCP/IP <host> sets
  1368.   this too, so the next SET PORT TCP/IP command remembers it if you omit the
  1369.   host.  This allows you to switch back and forth between serial and TCP/IP
  1370.   connections.
  1371.  
  1372. SET TCP/IP DOMAIN <domain-name>
  1373.   IP domain name for your organization or department, for example columbia.edu
  1374.   for Columbia University, cc.columbia.edu for the Computer Center at Columbia
  1375.   University.  This lets you refer to hosts on your local network with
  1376.   nicknames, for example watsun rather than watsun.cc.columbia.edu.  When a
  1377.   hostname given in your SET PORT TCP/IP command can't be found, Kermit appends
  1378.   the domain and tries again.  If it still can't be found, Kermit trims the
  1379.   leftmost field from the domain and tries again, and so on until the host is
  1380.   found or the domain name is used up:
  1381.     SET TCP/IP DOMAIN cc.columbia.edu
  1382.     SET PORT TCP/IP oofa.cs
  1383.   Kermit tries (in this order): oofa.cs, oofa.cs.cc.columbia.edu,
  1384.   oofa.cs.columbia.edu, oofa.cs.edu.
  1385.  
  1386. SET TCP/IP PACKET-DRIVER-INTERRUPT { <number>, ODI }
  1387.   (Version 3.12 and later.)  MS-DOS Kermit normally searches for the packet
  1388.   driver beginning at interrupt \x60 and going up the \x80.  You can use this
  1389.   command to disable MS-DOS Kermit's automatic search and specify a particular
  1390.   interrupt number, for example, SET TCP PACKET-DRIVER \x63.  If you specify
  1391.   "ODI" instead of an interrupt number, Kermit uses ODI rather than
  1392.   packet-driver conventions for communicating with the network board driver.
  1393.   ODI support is available in version 3.12 and later.
  1394.  
  1395. SET TCP/IP TELNET-TERM-TYPE <name>
  1396.   (Version 3.12 and later.)  Normally MS-DOS Kermit sends the name of terminal
  1397.   it is currently emulating, for example, "VT320", in response to a
  1398.   terminal-type request from the remote TELNET server.  Use this command to
  1399.   supply any terminal-type name of your choosing.
  1400.  
  1401. Sample TCP-related commands for MSCUSTOM.INI (substitute your own correct
  1402. values for the ones shown here!):
  1403.  
  1404.   SET TCP/IP ADDRESS 128.59.77.23              ; Your PC's IP address
  1405.   SET TCP/IP SUBNETMASK 255.255.255.0          ; Your local net's subnet mask
  1406.   SET TCP/IP GATEWAY 128.59.77.1               ; The gateway on your local net
  1407.   SET TCP/IP PRIMARY-NAMESERVER 128.59.77.19   ; Nameserver on your local net
  1408.   SET TCP/IP SECONDARY-NAMESERVER 128.59.78.12 ; Fallback nameserver
  1409.   SET TCP/IP DOMAIN bar.baz.edu                ; Your local IP domain name
  1410.  
  1411. Then, to make a TCP/IP connection:
  1412.  
  1413.   SET PORT TCP/IP foo                          ; Connect to foo.bar.baz.edu
  1414.   CONNECT
  1415.  
  1416. The TCP/IP connection is not actually established until the CONNECT (or INPUT
  1417. or OUTPUT or similar) command is given, at which time some progress messages
  1418. are displayed on your screen.  If connection is immediate, you won't see these
  1419. messages, but if the connection fails, they will remain visible so you'll know
  1420. why it failed.
  1421.  
  1422. Logging out from the remote host will normally terminate your session and
  1423. pop you back to the MS-Kermit> prompt.  The HANGUP command, or Ctrl-]H during
  1424. terminal emulation, should do the same thing.
  1425.  
  1426. If your network has a BOOTP server, Kermit can learn its own IP address, as
  1427. well as the nameserver addresses, gateway address, and subnet mask from the
  1428. server if the BOOTP server's database has an entry for your PC that contains
  1429. these items.  Then, only commands you need to set up your TCP connection are:
  1430.  
  1431.   SET TCP/IP SUBNETMASK 255.255.254.0 ; Subnet mask
  1432.   SET TCP/IP DOMAIN bar.baz.edu       ; Your local IP domain name
  1433.   SET TCP/IP ADDRESS BOOTP            ; Get other info via BOOTP
  1434.  
  1435.   SET PORT TCP/IP <name-or-number>    ; Establish a connection
  1436.   CONNECT
  1437.  
  1438. The SET TCP/IP SUBNETMASK command is necessary only if your subnetwork uses
  1439. a different mask than Kermit's default, which is 255.255.255.0.  These
  1440. commands should go in your MSCUSTOM.INI file.
  1441.  
  1442. Kermit sends an IP broadcast message to find the BOOTP server.  If
  1443. you also have given SET TCP/IP ADDRESS, SUBNETMASK, PRIMARY-NAMESERVER,
  1444. SECONDARY-NAMESERVER, and GATEWAY commands, their values will be superseded by
  1445. any values sent by the BOOTP server.
  1446.  
  1447. BOOTP service has the great advantage that PC network configurations need be
  1448. maintained in only one central file, rather than on many individual PCs.  If
  1449. the BOOTP server is unavailable, users can still enter the required information
  1450. with SET TCP/IP commands.  A BOOTP server for Berkeley UNIX is available by
  1451. anonymous FTP from lancaster.andrew.cmu.edu [128.2.13.21] in pub/bootp.?.?.tar
  1452. (or .tar.Z), where ?.? is the current bootp release number, such as 2.1.  It
  1453. is also available from Columbia University via anonymous ftp from
  1454. watsun.cc.columbia.edu in the bootp directory.
  1455.  
  1456. If your network has a RARP server, Kermit can learn its own IP address from the
  1457. server, if the RARP server's database contains an entry for your PC.  The RARP
  1458. server can't tell you the subnetmask, nameserver addresses, or gateway address,
  1459. so you will still need these items in your MSCUSTOM.INI file.  However,
  1460. everybody on the same physical network can use the same TCP/IP network
  1461. parameters in their MSCUSTOM.INI files because the SET TCP/IP parameters other
  1462. than ADDRESS are all the same.
  1463.  
  1464. HINT: To avoid typing long SET PORT TCP/IP commands, define a macro for each
  1465. host you commonly connect to:
  1466.  
  1467.   DEFINE OOFA SET PORT TCP/IP OOFA, PAUSE 0, IF SUCCESS CONNECT
  1468.  
  1469. Put these definitions in your MSCUSTOM.INI file.  Then just type "OOFA" to
  1470. connect to TCP/IP host OOFA.  The standard sample MSCUSTOM.INI file already
  1471. defines a TELNET macro for you:
  1472.  
  1473.   DEFINE TELNET SET PORT TCP/IP \%1 \%2, PAUSE 0, IF SUCCESS CONNECT
  1474.  
  1475. (End of MS-DOS Kermit 3.11 /3.12 Help File)
  1476.